---
title: 面向 Claude 桌面版用户
description: 开始在 Claude for Desktop 中使用预构建的服务器
---

在本教程中，您将扩展 [Claude for Desktop](https://claude.ai/download)，使其能够读取您计算机的文件系统、写入新文件、移动文件，甚至搜索文件。

<Frame>
  <img src="/images/quickstart-filesystem.png" />
</Frame>

别担心——它会在执行这些操作前请求您的许可！

## 1. 下载 Claude for Desktop

首先，下载 [Claude for Desktop](https://claude.ai/download)，选择 macOS 或 Windows。（Linux 目前尚不支持 Claude for Desktop。）

按照安装说明进行操作。

如果您已经安装了 Claude for Desktop，请确保其为最新版本：点击计算机上的 Claude 菜单，选择“检查更新...”

<Accordion title="为什么选择 Claude for Desktop 而不是 Claude.ai？">
由于服务器是本地运行的，MCP 目前仅支持桌面主机。远程主机的开发正在积极进行中。
</Accordion>

## 2. 添加文件系统 MCP 服务器

为了添加文件系统功能，我们将为 Claude for Desktop 安装一个预构建的 [文件系统 MCP 服务器](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)。这是由 Anthropic 和社区创建的众多[服务器](https://github.com/modelcontextprotocol/servers/tree/main)之一。

首先，打开计算机上的 Claude 菜单，选择“设置...”。请注意，这不是应用程序窗口中的 Claude 账户设置。

在 Mac 上的样子如下：
<Frame style={{ textAlign: 'center' }}>
  <img src="/images/quickstart-menu.png" width="400" />
</Frame>

在设置面板的左侧栏点击“开发者”，然后点击“编辑配置”：
<Frame>
  <img src="/images/quickstart-developer.png" />
</Frame>

这将在以下位置创建一个配置文件（如果您尚未拥有一个），并在文件系统中显示该文件：
- macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows：`%APPDATA%\Claude\claude_desktop_config.json`

使用任意文本编辑器打开配置文件。将文件内容替换为以下内容：
<Tabs>
<Tab title="MacOS/Linux">
```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
```
</Tab>
<Tab title="Windows">
```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\username\\Desktop",
        "C:\\Users\\username\\Downloads"
      ]
    }
  }
}
```
</Tab>
</Tabs>

确保将 `username` 替换为您的计算机用户名。路径应指向您希望 Claude 能够访问和修改的有效目录。默认设置为桌面和下载文件夹，但您也可以添加更多路径。

您还需要在计算机上安装 [Node.js](https://nodejs.org) 以确保正常运行。要验证是否已安装 Node，请打开计算机上的命令行：
- 在 macOS 上，从应用程序文件夹打开终端
- 在 Windows 上，按 Windows + R，输入 "cmd"，然后按回车

进入命令行后，通过输入以下命令验证是否已安装 Node：
```bash
node --version
```
如果出现“命令未找到”或“node 未被识别”的错误，请从 [nodejs.org](https://nodejs.org/) 下载 Node。

<Tip>
**配置文件是如何工作的？**

此配置文件告诉 Claude for Desktop 在每次启动应用程序时启动哪些 MCP 服务器。在本例中，我们添加了一个名为“filesystem”的服务器，它将使用 Node 的 `npx` 命令安装并运行 `@modelcontextprotocol/server-filesystem`。此服务器（详情见[此处](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)）将允许您在 Claude for Desktop 中访问文件系统。
</Tip>

<Warning>
**命令权限**

Claude for Desktop 将以您的用户账户权限运行配置文件中的命令，并可访问您的本地文件。仅添加您理解并信任来源的命令。
</Warning>

## 3. 重启 Claude

更新配置文件后，您需要重启 Claude for Desktop。

重启后，您应该在输入框的右下角看到一个锤子 <img src="/images/claude-desktop-mcp-hammer-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> 图标：

<Frame>
  <img src="/images/quickstart-hammer.png" />
</Frame>

点击锤子图标后，您应该看到文件系统 MCP 服务器提供的工具：

<Frame style={{ textAlign: 'center' }}>
  <img src="/images/quickstart-tools.png" width="400" />
</Frame>

如果 Claude for Desktop 未识别您的服务器，请继续阅读[故障排除](#troubleshooting)部分以获取调试提示。

## 4. 试用一下！

您现在可以与 Claude 对话并询问有关文件系统的问题。它应该知道何时调用相关工具。

您可以尝试问 Claude 的一些问题：
- 你能写一首诗并保存到我的桌面上吗？
- 我的下载文件夹中有哪些与工作相关的文件？
- 你能将桌面上的所有图片移动到一个名为“Images”的新文件夹吗？

根据需要，Claude 将调用相关工具并在执行操作前请求您的批准：
<Frame style={{ textAlign: 'center' }}>
  <img src="/images/quickstart-approve.png" width="500" />
</Frame>

## 故障排除

<AccordionGroup>
<Accordion title="Claude 中未显示服务器 / 缺少锤子图标">
  1. 完全重启 Claude for Desktop
  2. 检查 `claude_desktop_config.json` 文件的语法
  3. 确保 `claude_desktop_config.json` 中包含的文件路径有效，并且是绝对路径而非相对路径
  4. 查看[日志](#getting-logs-from-claude-for-desktop)以了解服务器未连接的原因
  5. 在命令行中，尝试手动运行服务器（将 `username` 替换为您在 `claude_desktop_config.json` 中使用的用户名），查看是否有错误：
<Tabs>
<Tab title="MacOS/Linux">
```bash
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/Downloads
```
</Tab>
<Tab title="Windows">
```bash
npx -y @modelcontextprotocol/server-filesystem C:\Users\username\Desktop C:\Users\username\Downloads
```
</Tab>
</Tabs>
</Accordion>
<Accordion title="从 Claude for Desktop 获取日志">
  与 MCP 相关的 Claude.app 日志记录在以下位置的日志文件中：
  - macOS：`~/Library/Logs/Claude`
  - Windows：`%APPDATA%\Claude\logs`

  - `mcp.log` 包含有关 MCP 连接和连接失败的常规日志。
  - 名为 `mcp-server-SERVERNAME.log` 的文件包含来自指定服务器的错误（stderr）日志。

  您可以运行以下命令列出最近的日志并跟踪任何新日志（在 Windows 上，仅显示最近的日志）：
<Tabs>
<Tab title="MacOS/Linux">
```bash
# 检查 Claude 的日志是否有错误
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
```
</Tab>
<Tab title="Windows">
```bash
type "%APPDATA%\Claude\logs\mcp*.log"
```
</Tab>
</Tabs>
</Accordion>
<Accordion title="工具调用无声失败">
  如果 Claude 尝试使用工具但失败：

  1. 检查 Claude 的日志是否有错误
  2. 验证您的服务器构建并运行无错误
  3. 尝试重启 Claude for Desktop
</Accordion>
<Accordion title="这些都不起作用。我该怎么办？">
  请参阅我们的[调试指南](/docs/tools/debugging)，以获取更好的调试工具和更详细的指导。
</Accordion>
<Accordion title="Windows 上出现 ENOENT 错误和路径中的 ${APPDATA}">
如果配置的服务器无法加载，并且您在日志中看到路径中包含 `${APPDATA}` 的错误，您可能需要在 `claude_desktop_config.json` 的 `env` 键中添加 `%APPDATA%` 的扩展值：

```json
{
  "brave-search": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
    "env": {
      "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\",
      "BRAVE_API_KEY": "..."
    }
  }
}
```

完成此更改后，再次启动 Claude Desktop。

<Warning>
**NPM 应全局安装**

如果未全局安装 NPM，`npx` 命令可能会持续失败。如果已全局安装 NPM，您会发现系统中存在 `%APPDATA%\npm`。如果没有，您可以通过运行以下命令全局安装 NPM：

```bash
npm install -g npm
```
</Warning>

</Accordion>
</AccordionGroup>

## 下一步
<CardGroup cols={2}>
  <Card
    title="探索其他服务器"
    icon="grid"
    href="/examples"
  >
    查看我们的官方 MCP 服务器和实现画廊
  </Card>
  <Card
    title="构建您自己的服务器"
    icon="code"
    href="/quickstart/server"
  >
    现在构建您自己的自定义服务器，以在 Claude for Desktop 和其他客户端中使用
  </Card>
</CardGroup>